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FIG. 7 



700 



XMLElement: company 

name=''Acme" 
url="http ://acmexom" 



XMLElement: employee 
name="Paur' 
officeNumber="400" 



XMLElement: employee 
name="John" 
officeNumber="500" 
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FIG. 8 



800 

Class: SerializedObject (abstract class) 
Attributes: name, value, className, children 
Methods: serializeQ ? deserializeQ 





Class: PrimitiveObject ^ 
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Class: ArrayObject ^ 
Attributes: length 
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FIG. 9 



900 



9f0 Class Person 
{ 

public String name; 
private int age; 

} 



920 Class Employee extends Person 
{ 

protected String title; 
protected long officeNumber; 

public Employee(String name, int age, String title, long officeNumber) { ... } 

} 



// Create a new instance of an employee 
930 Employee bill = new Employee("William", 20, "Engineer", 117); 
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UserObject 

name="biir 
className="Employee" 



1000 



1020 



UserClass 
name-'Person" 
serialVersion="12345" 



1030 



SpecialObject 

name="naine" 
className="java.lang.String' 
value="William" 



PrimitiveObject 

name-'age" 
className="int" 
value="20" 



1050 



UserClass 

nanie=''Employee" 
serialVersion="67890" 



SpecialObject 

name=''title" 
className="java.lang.String" 
value="Engineer*' j 



PrimitiveObject 

name="officeNumber" 
className="long" 
value="lir 
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XMLElement: object 

name="biir' 
className-'Employee'' 
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FIG. 11 



1100 



XMLElement: class 
name='Terson*' 
serialVersion="12345" 



1130 



XMLElement: special-object 
name="name" 
classNaine="java.lang.String" 
value^^WiUiam" 



XMLElement: primitive 
name="age" 
classNameF="inf' 
value="20" 



XMLElement: class 
name="Employee" 
serialVersion="67890" 



XMLElement: speciakobject 

name=''title" 
className="java.lang.String'- 
value="Engineer" 



XMLElement: primitive 
name="oflSceNiimber" 
className="long" 
value="117' 
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FIG. 13 



1305 


^serializeQ 


1310 


f ^ 

UseiObject 
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V J 
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deserializeQ 



UserClass 

namB="PCTSon" 
S€rialVersion="12345" 
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SpecialObject 

naiTief="naine" 
classNainB=^'java.lang.String" 
value="Wlliani" 



1330 



PrimitiveObject 

nanie="age" 
classNanie?=^'mt" 
value="20" 
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UserOass 
nanie="Eniployee" 
serialVersion="67890" 
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SpecialObject 

name="titie" 
dassNanis="java.lang.Stiing'' 
valiie=*'Engineer^* 



1370 



PrimitiveObject 

naine="ofl5ceNumber" 

className=*'long" 
value="lir 
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FIG. 14 
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FIG. 15 



1SO0 

/ 

Object 



-^-^ — \XMLEIement 



Deserialization Engine 



Object 



1510 
1540 



1545 



^1550 

■ XML 



XML Parser 



^1560 

InputStream 



1555 



XMLEIement(DOM Graph) 



Deserializer 



Object 



1535 



^1515 

(Object, Attributes) 



Java Reflection API 

^420 



(access 
check) 



-1525 



Security Manager 

^430 



RSW920030146US1 
Serialization and Preservation of Ot^jects 
K.A.Mirelcu 



13/27 

FIG. 16 
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2200 public abstract class Person 

2210 implements Serializable, SerializedObjectlmporter 

{ 

■protected String GUEST_ACCOUNT[ ] = 
new String! ] {"unix", "guest", "secret"}; 

2220 private String name; 

private String address; 
private Vector accounts = new Vector(); 

/** Constructor */ 

public Person(String name, String address) 
{ 

this.name = name; 

this.address = address; 2230 
accounts.add(GUESTJKCCOUNT); 

} 

/** Member functions */ 
public String getNameQ { return name; } 
public String getAddressQ { retum address; } 

* Imports a serialized object into this object. This function is 

* called by the default deserializer for each object to customize 

* the import of the serialized object. The default object importer 

* may be called from this function to perform the default import. 

* @param serialHandle Serialized object handle. 

* @param userObject Serialized user object. 
*/ 

2240 public void customObjectlmport(Object serialHandle, UserObject userObject) 
throws XMLObjectStreamException, ClassNotFoundException 



{ 



// Perform the default object import at the root class 
userObject.defaultObjectlmport(serialHandle, this); 

// Get the serialized class entry for this class 

UserClass userClass = userObject.getClass(Person.class); 



// Perform manual import of changed and new fields 

2250 



if (userClass. isClassDjfferent(this)) 
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FIG. 23 



2300 public class Employee extends Person 



{ 



2310 



private int officeNumber; 
private String emailAddress; 
private Date creatlonDate; 
private Vector roles = new Vector(); 



/** Constructor */ 
2320 public Employee(String name, String address, 

int officeNumber, String emailAddress) 

{ 

super(name, address); 
this.officeNumber = officeNumber; 
Jhis.emailAddress = emailAddress; 
this.creationDate = new DateQ; 



2330 



II Create the roles 

this.roles.addfAdministrator"); 

this.roles.add("Manager"); 



/** Member functions */ 

public int getOfficeNumber() { return officeNumber; } 
public String getEmailAddressQ { return emailAddress; } 
public String getDateHiredQ { return creationDate.toStringQ; } 

/** Displays user information */ 
public void displayUserlnformationQ 
{ 

System.out.printlnCAnEmployee Infonnation (Employee)"); 
System.out.println("\tName: " + getNameO); 
System.out.println("\tAddress: " + getAddressQ); 
System.out.printlnOtOffice number: " + getOfficeNumberQ); 
System.out.println("\tEmail address: " + getEmailAddressQ); 
System.out.println("\tDate Hired: " + getDateHiredQ); 
System.out.printlnOtRoles: " + roles.elementAt(0).toStringQ + " 
+ roles.elementAt(l).toStringQ); 

} 

} 
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FIG. 24 



2400 

import util.xml.stream *; 
import util.xml.objectstream.*; 

FilelnputStream isv, 
FileOutputStream fso; 
XMLObjectlnputStream xsi; 
XMLObjectOutputStream xso; 
Employee employee; 



// Create a new object 
2A10 employee = new Employee("Michael Smith", "2400 Oak Street", 17, 

"michael@internet.com"); 
2420 employee.displayUserlnformationO; 



2430 



II Write XML serialized object 

fso = new FileOutputStream("output.xmr'); 

y&o = new XMLObjectOutputStream(feo); 

xso.writeObject(employee); 

xso.closeO; 



[_er 



2Jfjfff\ • Discard the object 
employee = null; 



// Read XML serialized object 
fsi = new FilelnputStream("output.xml"); 
2450 xsi = new XMLObjectlnputStream(fsi); 

employee = (Employee) xsi.readObjectQ; 
employee.displayUserlnformationO; 
xsi.closeQ; 
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FIG. 25 

2SiiO 

2510 Employee Information (Employee) 
Name: Michael Smith 
Address: 2400 Oak Street 
Office number: 17 

Email address: michael@internet.com 
Date Hired: Thu Aug 14 14:30:30 EOT 2003 
Roles: Administrator, Manager 

2520 Employee Information (Employee) 
Name: Michael Smith 
Address: 2400 Oak Street 
Office number 17 

Email address: mlchael@internet.com 
Date Hired: Thu Aug 14 14:30:30 EDT 2003 
Roles: Administrator, Manager 
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FIG. 27A 

^ 2710 

public class NewEmployee extends Person 

{ 

private String officeNumber; // ** Modified type ** 

//private String emailAddress; // ** Deleted field ** 

2720 private String title; //** Added field ** 

private Date dateHired; // ** Renamed field ** 

private String roles[ ]; // ** Modified type ** 

/** Constmctor */ 

27Z0 public NewEmployee(String name, String address, String officeNumber) 
{ 

super(name, address); 
this.officeNumber = officeNumber; 
this .title = "Associate"; 
this.dateHired = new Date(); 



// Create the roles 

this.roies = new String[ ] {"Developer", 'Tester"}; 



} 



/*** Member functions */ 

public String getOfficeNumber() { return officeNumber; } 

public String getTitle() { return title; } 

public String getDateHired() { return dateHired.toString(); } 

/** Displays user information *l 
public void displayUserinformation() 

{ 

System.out.println("\nEmployee Information (NewEmployee)"); 
System.out.println("\tName: " + getNameQ); 
System.out.println("\tAddress: " + getAddress()); 
System.out.println("\tOffice number: " + getOfficeNumber()); 
System.out.println("\tTitle: " + getTitleO); 
System.out.println("\tDate Hired: " + getDateHiredO); 
System.out.println("\tRoles: " + roles[0] + ", " + roles[1]); 
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FIG. 27B 



1** 

* Imports a serialized object into this object. This function is 

* called by the default deserializer for each object to customize 

* the import of the serialized object. The defeult object importer 

* may be called from this function to perform the default import. 

* @param serialHandle Serialized object handle. 

* @param userObject Serialized user object. 
*/ 

"public void customObjectlmport(Object serialHandle, UserObject userObject) 
throws XMLObjectStreamException, ClassNotFoundException 

{ 

// Invoke super classes to perform class specific imports 
super.customObjectlmport(serialHandle, userObject); 

// Get the serialized class entry for this class 
2750 userObject.changeClassNameC'Employee", "NewEmployee", true); 
UserClass userClass = userObject.getClass(NewEmployee.class); 

// Perform manual import of changed and new fields 
2760 if (userClass.lsClassDifferent(this)) 
{ 

2770 officeNumber = userClass.getField("officeNumbeO getValue(); 
2780 title = "Engineer ("+userClass.getField("emailAddress").getValue()+")' 
2790 dateHired = 

(Date) userClass.getField("creationDate").deserialize(serialHandie); 

// Convert the roles from a Vector to a String array 
Vector rolesData = 

(Vector) userClass.getField("roles").deserjalize(serialHandle); 
2795 roles = (String[ ]) roiesData.toArray(newString[rolesData.size()]); 
} 

} 
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FIG. 28 



2S00 

II Open the XML file containing the previously serialized object 
fei = new FilelnputStreamC'output.xml"); 

// Specifying the serializer allows partial or complete control 

// over the serialization and deserialization of the object. 

// The defeult serializer may be extended to update class names 

// before deserialization. Specifying the defeult serializer 

// is equivalent to not specifying it at all, with the present API. 

xsi = new XML0bjectlnputStream(f5i, new DefaultXMLSerializer()); 

// Read XML serialized object into a different class. 
// If the default serializer was extended to change the class 
// name from 'Employee' to 'NewEmployee', then the readObject() 
// below could be called without any parameters. 
2B10 NewEmployee newEmployee = 

(NewEmployee) xsi.readObject(new NewEmployee("", "", "")); 
newEmployee.displayUserlnformationO; 



FIG. 29 

2900 

Employee Information (NewEmployee) 
Name: Michael Smith 
Address: 2400 Oak Street 
Office number: 17 
29f0 Title: Engineer (michael@internet.com) 

Date Hired: Thu Aug 14 14:30:30 EDT 2003 
Roles: Administrator, Manager 
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FIG. 30 

Grammar 



stream ::= header seriaiized-object 
serialized-object ::= element("serialized", object) 

object ::= user-object | special-object | array | primitive 

user-object ::= element("object", 0*user-class) 

user-class ::= element("class", O*object) 

special-object ::= element("special-object", O^object) 

array :;= element("array", O*object) 

primitive ::= element("primitive") 



Literals 



header ::= <XML version control header> 

element(tagname) ::= <XML element with specified 

tag name and zero children> 

element(tagname,child) ::= <XIVIL element with specified 

tag name and child elements> 



Tag Attributes 

serialized: method version 

class: name version 

object: [name] class reference [link] 

anray: [name] class reference [link] length 

special-object: [name] class [value] reference [link] method 

primitive: [name] class value 



